Fatura

Fatura Bilgisi Gönderimi

POST/api/v1/invoice/create

bilgi

ERP'de kesilen fatura bilgilerini iletir. Tek seferde en fazla 100 fatura gönderilebilir.

Request Body

[
  {
    "orderId": 1923,
    "integrator": "ISNET",
    "ettn": "f3dec1ee-6a1b-11eb-9439-0242ac130002",
    "invoiceNumber": "11111",
    "profileID": "EARSIVFATURA",
    "issueDate": "2021-01-09T10:30",
    "companyVendorNumber": "01",
    "invoiceUrl": "[https://app.treewin.com.tr](https://app.treewin.com.tr)"
  }
]

Responses

Kod	Açıklama	Örnek Değer
200	OK	[ { "message": "string", "result": "Başarılı" } ]
400	Bad Request
413	Payload Too Large	{ "view": { "contentType": "string" }, "model": { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} }, "status": "100 CONTINUE", "empty": true, "viewName": "string", "reference": true, "modelMap": { "empty": true, "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } }

---

Fatura İptal Bilgisi Gönderimi

POST/api/v1/invoice/cancel

bilgi

ERP'de iptal edilen fatura bilgilerini iletir. Tek seferde en fazla 100 fatura gönderilebilir.

Request Body

[
  {
    "ettn": "f3dec1ee-6a1b-11eb-9439-0242ac130002",
    "cancelDate": "2021-01-09T10:30",
    "cancellationReason": "Müşteri talebi"
  }
]

Responses

Kod	Açıklama	Örnek Değer
200	OK	[ { "message": "string", "result": "Başarılı" } ]
400	Bad Request
413	Payload Too Large	{ "view": { "contentType": "string" }, "model": { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} }, "status": "100 CONTINUE", "empty": true, "viewName": "string", "reference": true, "modelMap": { "empty": true, "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } }

---

Fatura Listesi

GET/api/v1/invoice/list

Uyarı

Verilen parametrelerden en az biri zorunludur:

• issueDateStart + issueDateEnd
• orderId
• orderNumber
• invoiceNumber
• ettn

Tarih-saat query parametreleri biçimi:

• ISO 8601 yyyy-MM-dd'T'HH:mm:ss (ör. 2000-10-31T01:30:15; saat-dakika-saniye, offset yok). page 1'den başlar; pageSize varsayılan 100, en çok 1000.

Parameters

Veri Tipi	Alan Adı	Açıklama	Varsayılan Değer
string($date-time)	issueDateStart	Fatura Tarihi Başlangıç
string($date-time)	issueDateEnd	Fatura Tarihi Bitiş
string	orderId	TreeWin Sipariş ID
string	orderNumber	Sipariş Numarası
string	invoiceNumber	Fatura Numarası
string	ettn	ettn
array[integer]	invoiceStatus	Fatura Durumu
integer($int32)	page	Sayfa
integer($int32)	pageSize	Sayfadaki Sipariş Sayısı	100

Responses

Kod	Açıklama	Örnek Değer
200	OK	{ "content": [ { "orderId": "123456789", "orderNo": "SIP20250716", "orderDate": "2026-07-01T11:39:27.183Z", "status": "2", "customerFullName": "Ali Veli", "customerTc": "11111111111", "customerVkn": "1111111111", "customerPhone": "05000000000", "customerMail": "mail@example.com", "shippingFullName": "Ali Veli", "shippingCountry": "Türkiye", "shippingCity": "Ankara", "shippingDistrict": "Çankaya", "shippingAddress": "123. Sokak No:4 Kat:5", "shippingPhone": "05000000000", "shippingMail": "mail@example.com", "shippingNote": "Lütfen kapıya dikkatli bırakın", "billingFullName": "Ali Veli", "billingCountry": "Türkiye", "billingCity": "Ankara", "billingDistrict": "Çankaya", "billingAddress": "123. Sokak No:4 Kat:5", "billingPhone": "05000000000", "billingMail": "mail@example.com", "billingTc": "11111111111", "billingVkn": "1111111111", "billingTaxOffice": "Çankaya Vergi Dairesi", "shippingAmount": 0, "extraAmount": 0, "totalAmount": 0, "installmentAmount": 0, "cargoCompanyId": "99", "paymentTypeId": 4, "installment": 0, "paymentProvider": "Garanti Bankası", "cargoCode": "AB123456789", "cargoTrackingCode": "AB123456789", "companyVendorNumber": "00", "items": [ { "itemId": "ITEM123456789", "sku": "SKU-00123", "siteSku": "SITESKU98765", "barcode": "8691234567890", "groupCode": "GRP-01", "title": "Kırmızı Kadın Tişört", "brand": "Marka", "variantText": "Beden: M, Renk: Kırmızı", "quantity": 0, "price": 0, "totalAmount": 0, "discountAmount": 0, "totalAmountWithVat": 0, "vatRate": 0, "vatAmount": 0, "finalTotalAmountWithVat": 0, "status": "5" } ], "invoiceUrl": "https://example.com/invoice/ORD123456789", "webSite": "https://www.ornekpazaryeri.com" } ], "page": 0, "pageSize": 0, "totalElements": 0, "totalPages": 0 }
400	Bad Request
413	Payload Too Large	{ "view": { "contentType": "string" }, "model": { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} }, "status": "100 CONTINUE", "empty": true, "viewName": "string", "reference": true, "modelMap": { "empty": true, "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } }